AFCTN  Test  Report 
94-093 


AFCTB-ID 

94-058 


TMSS  Parsing  Test 
MIL-M-83495A  Fault  Reporting 
Document  Type  Definition 

MAXIMA  Corporation 

DISA  Contract  #DCA100-93-D-0065 

Quick  Short  Test  Report 

20  May  1994 


Prepared  for 

Electronic  Systems  Center 
Air  Force  CALS  Program  Office 
HQ  ESCfAV^2 

4027  Colonel  Glenn  Hwy  Suite  300 
Dayton  OH  45431-1672 


[»nC  Q17ALIT7  msPEOTED  3 


DISfRIBUTION  STATEMIOT  A 

Approved  for  public  release; 
Distribution  Unlimite^i 


AFCTN  Test  Report 
94-093 


AFCTB-ID 

94-058 


TMSS  Parsing  Test 
MIL-M-83495A  Fault  Reporting 
Document  Type  Definition 

For: 

MAXIMA  Corporation 

DISA  Contract  #DCA100-93-D-0065 

Quick  Short  Test  Report 
20  May  1994 


Prepared  By 

Air  Force  CALS  Test  Bed 
Wright -Patterson  AFB,  OH  45433 

AFCTB  Contact 

Gary  Lammers 
(513)  427-2295 

AFCTN  Contact 

Mel  Lammers 
(513)  427-2295 


DTIC  QUAUry  mSPBOTED  3 


AFCTN  Test  Report 
94-093 


AFCTB  Test  Report 
94-058 


DISCLAIMER 


This  docxjment  was  prepared  as  an  account  of  the  work  spon¬ 
sored  by  the  Air  Force.  Neither  the  United  States  Govern¬ 
ment,  the  Air  Force,  nor  any  of  their  employees  makes  any 
warranty,  express  or  implied,  or  assumes  any  legal  liability 
or  responsibility  for  the  accuracy,  completeness,  or  use¬ 
fulness  of  any  information,  apparatus,  product,  or  process 
disclosed,  nor  represents  that  its  use  would  not  infringe  on 
privately  owned  rights.  Reference  herein  to  any  specific 
commercial  products,  process,  or  service  by  trade  name, 
trademark,  manufacturer,  or  otherwise,  does  not  necessarily 
constitute  or  imply  its  endorsement,  recommendation,  or 
favoring  by  the  United  States  Government  or  the  Air  Force. 
The  views  and  opinions  of  authors  expressed  herein  do  not 
necessarily  state  or  reflect  those  of  the  United  States 
Government  or  the  Air  Force,  and  shall  not  be  used  for 
advertising  or  product  endorsement  purposes. 


Available  to  the  public  from  the 
National  Technical  Information  Service 
U.S.  Department  of  Commerce 
5285  Port  Royal  Road 
Springfield,  VA  22161 


This  report  and  those  involved  in  its  preparation  do  not 
endorse  any  product,  process,  or  company  stated  herein.  Use 
of  these  means  by  anyone  does  not  imply  certification  by  the 
Air  Force  CALS  Test  Network  (AFCTN) . 
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1.  Introduction 
1.1  Background 


The  Department  of  Defense  (DoD)  Air  Force  Continuous  Acqui¬ 
sition  and  Life- cycle  Support  (CALS)  Test  Network  (AFCTN)  is 
conducting  tests  of  the  military  standard  for  the  Automated 
Interchange  of  Technical  Information,  MIL-STD-1840A,  and  its 
companion  suite  of  military  specifications.  The  AFCTN  is  a 
DoD  sponsored  confederation  of  voluntary  participants  from 
industry  and  government  managed  by  the  Electronic  Systems 
Center  (ESC) . 

The  primary  objective  of  the  AFCTN  is  to  evaluate  the 
effectiveness  of  the  CALS  standards  for  technical  data 
interchange  and  to  demonstrate  the  technical  capabilities 
and  operational  suitability  of  those  standards.  Two  general 
categories  of  tests  are  performed  to  evaluate  the  standards; 
formal  and  informal. 

Formal  tests  are  large  and  comprehensive,  which  follow  a 
written  test  plan,  require  specific  authorizatmon  from  the 
DoD,  and  may  take  months  to  prepare,  execute,  and  report. 

Informal  tests  are  quick  and  short,  used  by  the  AFCTN 
technical  staff,  to  broaden  the  testing  base.  They  include 
representative  samples  of  the  many  systems  and  applications 
used  by  AFCTN  participants.  They  also  allow  the  AFCTN  staff 
to  gain  feedback  from  many  industry  and  government  inter¬ 
pretations  of  the  standards,  to  increase  the  base  of  par¬ 
ticipation  in  the  CALS  initiative,  and  respond  to  the  many 
requests  for  help  that  come  from  participants.  Participants 
take  part  voluntarily,  benefit  by  receiving  an  evaluation  of 
their  latest  implementation  (interpretation)  of  the  stan¬ 
dards,  interact  with  the  AFCTN  technical  staff,  gain  expe¬ 
rience  using  the  standards,  and  develop  increased  confidence 
in  them.  The  results  of  informal  tests  are  reported  in 
Quick  Short  Test  Reports  (QSTRs)  that  briefly  summarize  the 
standard (s)  tested,  the  hardware  and  software  used,  the 
nature  of  the  test,  and  the  results. 
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1.2  Purpose 


The  purpose  of  this  informal  test  is  to  analyze  Air  Force 
Document  Type  Definitions  (DTDs)  for  Standard  Generalized 
Markup  Language  (SGML)  syntax,  using  several  commercial  and 
public  domain  SGML  parsers,  prior  to  placing  them  in  the 
Defense  Information  Systems  Agency  (DISA)  Asset  Source  for 
Software  Engineering  Technology  (ASSET)  repository. 
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2.  Test  Parameters 


Test  Plan:  AFCTB  94-058 

Date  of 

Evaluation:  20  May  1994 

Evaluator:  George  Elwood 

Air  Force  CALS  Test  Bed 
DET  2  HQ  ESC/AV-2P 
4027  Colonel  Glenn  Hwy 
Suite  300 

Dayton  OH  45431-1672 

Data 

Originator:  Kay  Hill 

MAXIMA  Corporation 
2372  Lake view  Drive 
Beavercreek  OH  45431 
(513)  427-5888 

Data 

Description:  Technical  Manual  Test 

1  DTD 

Data 

Source  System: 

Text /SGML 

SOFTWARE 

Unknown 

Evaluation  Tools  Used: 

MIL-M-28001  (SOIL) 

PC  486/50 

Exoterica  XGMLNorma.lizer  vl.2e3.2 
Exoterica  Validator  v2.2  exl 
McAfee  &  McAdam  Serna  Mark- it  v2.3 
Public  Domain  sgmls  vl.l 

Standards 

Tested:  MIL-M-28001B 
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3.  1840A  Analysis 
3.1  External  Packaging 


The  3.5"  diskette  was  hand  delivered  to  the  Air  Force  CALS 
Test  Bed  (AFCTB) .  It  was  not  enclosed  in  any  container. 

The  files  received  by  the  AFCTB  were  not  MIL-STD-1840A.  The 
files  were  not  named  per  the  standard  conventions,  as  the 
stated  purpose  of  the  evaluation  was  the  basic  data  struc¬ 
ture. 


4.  SGML  Analysis 


The  AFCTB  has  several  parsers  available  for  evaluating  sub¬ 
mitted  DTD  and  text  files.  These  tools  are  not  used  to 
generate  a  pass/fail  but  to  report  how  commercially  avail¬ 
able  software  can  handle  the  files.  These  products  are  used 
in  the  development  of  technical  publications  and  are  good 
indicators  of  usability.  The  use  of  these  products  is  not 
an  endorsement  nor  an  indication  of  CALS  capability.  All 
operations  were  performed  using  the  default  settings  unless 
specified  in  the  report. 

The  goal  was  to  configure  the  DTD  under  analysis  as  it  would 
normally  be  used.  However,  for  this  analysis  it  was  neces¬ 
sary  to  modify  the  DTD  adding  the  "DOCTYPE  doc  ["  statement 
to  the  start  and  the  companion  "]>"  to  the  end  of  the  DTD 
under  evaluation,  as  stated  in  the  comments  of  the  DTD.  If 
the  parser  did  not  support  a  formal  file  pointing  to  the 
location  of  the  ISO  character  sets,  this  was  added. 

The  DTD  under  evaluation,  MIL-M-83495A,  Appendix  E,  Fault 
Reporting,  called  for  a  companion  MIL-M-38784C  DTD.  MIL-M- 
38784C,  Amendment  three  DTD,  delivered  on  the  same  diskette 
as  the  DTD  to  be  evaluated,  was  used.  This  DTD  was  used 
without  change  except  to  insert  the  location  of  the  ISO 
character  set  files. 


<!--  MIL-M-83495A  Fault  Reporting  DTD  --> 
D495AEO.ORG  -->  D784CB0  .A3 
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The  following  notes  apply  to  the  parsing  analysis  as  indi¬ 
cated  in  the  ensuing  paragraphs. 

Note  1.  Entity  parameters  defined  more  than  once  is  a  vaild  SGML 
construct.  The  warnings  in  this  analysis  do  not  indicate 
cuiy  problems . 

Note  2.  Some  of  the  parsers  report  mixed  content  model  warnings. 

The  use  of  such  content  models  is  normaly  unnecessary  eind 
therefore  not  normally  recommended.  Record  boundaries 
within  elements  of  associated  instances  may  be  misinter¬ 
preted  where  a  mixed  content  model  exists  in  the  DTD. 

Note  3.  The  occurrences  of  warnings  "references  defined,  but  not 
used,"  appeared  because  portions  of  the  called  DTD,  i.e., 
MIL-M38784C,  were  not  used.  They  were  not  used  because 
the  entity  definitions  of  the  DTD  under  analysis  altered 
the  execution  path  in  the  called  DTD.  The  warnings  in 
this  analysis  do  not  indicate  any  problems. 


4.1  Exoterica  Validator 


The  DTD  file  was  evaluated  using  the  Exoterica  Validator  exl 
parser.  The  basic  DTD  was  modified  by  placing  the  concrete 
syntax  file  and  "<!D0CTYPE  doc  ["  at  the  start,  and  the  "]>" 
at  the  end.  The  parser  reported  85  errors  which  related  to 
the  missing  instance  and  are  not  considered  error  for  this 
analysis. 

The  parser  reported  26  total  warnings  of  three  types.  The 
first  type  warning  was  a  parameter  entity  declared  more  than 
once.  See  Note  l  above. 


<!--  **Waming**  in  "i:\dtd\784c.dtd"  (entity  "%in38784c" )  ,  line  37, 
used  in  "\xgml\9458 .dtd" ,  line  123: 

A  parameter  entity  name  has  been  declared  more  than  once. 

The  entity  is  "%shortitleuse" . 

<! ENTITY  %  shortitleuse  "IGNORE"  > 


The  second  type  warning  related  to  elements  of  mixed  content 
model.  See  Note  2  above. 


<!--  **Waming**  in  "\xgml\9458  .dtd" ,  line  138: 
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An  element  with  mixed  content  should  permit  data  characters  ("ttPCDATA") 
everywhere . 

The  element  being  declared  is  "CBLOC" . 

<!ELEMENT  cbloc  -  o  (%text;,  cb+)  > 


The  first  line  below  shows  the  initial  element  definition  in  the  DTD. 
The  second  line  is  the  line  as  shown  above,  revealing  the  mixed 
content  occurrence.  See  Note  2  above. 


<! ELEMENT  cb  -  o  (%text;)  > 

<! ELEMENT  cbloc  -  o  (%text;,  cb+)  > 


The  third  type  warning  related  to  elements  defined  but  not 
used  in  any  content  model .  See  Note  3  above . 


<!--  **Waming**  in  ''\xgml\9458  .dtd" ,  line  206: 

An  element  is  not  allowed  in  the  docioment  instance  because  it  does  not 
appear  in  any  accessible  content  model  or  it  is  conpletely  excluded. 
The  element  is  "ADDRESS". 

4.2  Exoterica  XGML  Normalizer 


The  DTD  file  was  parsed  using  the  Exoterica  XGMLNormalizer 
parser.  The  concrete  syntax  and  "<!DOCTyPE  doc  ["  were 
added  to  the  start,  and  "]>"  to  the  end  of  the  file.  One 
warning  related  to  a  mixed  context  model,  was  issued  by 
this  utility.  See  Note  2  above. 


C:\XGML\XGMLNORM.EXE  -- 

Warning  on  line  138  in  file  9458. dtd: 

An  element  with  mixed  content  does  not  permit  data  characters 
everywhere . 

Spaces  and  line  breaks  in  element  'CBLOC  may  be  treated  as  data 
characters,  forcing  insertion  of  markup. 
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4.3  Public  Domain  sgmls 


The  DTD  file  was  evaluated  using  the  Public  Domain  sgmls  parser 
version  1.1.  The  file  was  modified  by  adding  the  "<!D0CTYPE  doc 
["  to  the  start,  and  "]>"  to  the  end  of  the  file  as  stated  in  the 
comments  in  the  DTD.  The  D784CB0.A3  file  was  used  as  the  point 
to  file.  Four  warnings  were  reported  by  the  parser,  all  of  which 
were  duplicate  definitions.  See  Note  1  above. 


sgmls:  In  file  included  at  \ws\9458 .dtd,  line  52: 

Warning  at  i:\dtd\784c.dtd,  line  37  in  declaration  parameter  4: 
Duplicate  specification  occurred  for  "%shortitleuse" ;  duplicate 
ignored . 


4.4  Serna  Mark>it 


The  DTD  file  was  evaluated  using  McAfee  &  McAdam's  Serna 
Mark-it  v2.3  parser.  The  file  was  modified  by  adding  the 
concrete  syntax  and  "<!D0CTYPE  doc  ["  to  the  start,  and 
"]>"  to  the  end  of  the  file.  One  warning  relating  to  a 
mixed  content  model  was  reported.  See  Note  2  above. 


<1..***  file :\xgml\9458 .dtd  line:138  pos:3897 

Potential  problem  in  the  mixed  content  model  of  element  CBLOC. 

At  some  location  within  the  model,  the  entry  of  separators  between  tags 
will  not  always  be  permitted.  It  is  often  possible  to  fix  this  problem 
by  writing  the  #PCDATA  model  token  in  a  repeatable  OR  group. --> 
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5.  Conclusions  and  Recommendations 


The  file  D495AEO.ORG,  MIL-M-83495A,  Appendix  E,  confonns  to 
the  SGML  syntax  of  ISO  Standard  8879,  as  required  by  the 
CALS  MIL-M-28001B  specification. 

The  errors,  warnings,  and  comments  reported  by  the  parsers 
used  in  this  evaluation  do  not  indicate  invalid  SGML  syn¬ 
tax.  However,  the  mixed  content  model  flagged  by  warnings 
from  three  of  the  five  parsers,  may  cause  problems  in  the 
use  of  this  DTD.  See  Note  2,  paragraph  4,  above. 

Recommend  the  DTD  be  changed  to  eliminate  the  mixed  content 
model.  If  this  is  not  possible,  users  should  be  alerted  to 
the  potential  problems  that  may  occur  in  the  application  of 
the  DTD,  and  proper  guidance  should  be  provided  users  to 
avoid  the  potential  problems  in  the  use  of  this  DTD. 


8 


AFCTN  Test  Report 
94.-093 


AFCTB  Test  Report 
94-058 


6.  Appendix  A  -  Detailed  SGML  Analysis 
6.1  Exoterica  Validator 


<1--  **Waming**  in  "i:\dtd\784c.dtd"  (entity  "%m38784c”),  line  37, 
used  in  ”\xgml\9458 .dtd” ,  line  123: 

A  parameter  entity  name  has  been  declared  more  than  once. 

The  entity  is  ”%shortitleuse” . 

<! ENTITY  %  shortitleuse  "IGNORE”  > 


<1--  **Waming**  in  "i:\dtd\784c.dtd"  (entity  "%m38784c”),  line  45, 
used  in  ”\xgml\9458 .dtd” ,  line  123: 

A  parameter  entity  name  has  been  declared  more  than  once . 

The  entity  is  ”%shortitle" . 

<! ENTITY  %  shortitle  "  "  > 


<!--  **Waming**  in  "i:\dtd\784c.dtd"  (entity  ”%m38784c”)  ,  line  107, 
used  in  ”\xgml\9458 .dtd” ,  line  123: 

A  parameter  entity  name  has  been  declared  more  than  once. 

The  entity  is  ”%fmt”. 

<1ENTITY  %  fmt  ”  (idinfo,  wampage?,  chginssht?,  lep,  verstat?, 


<1--  **Waming**  in  "i:\dtd\784c.dtd”  (entity  "%m38784c”)  ,  line  185, 
used  in  "\xgml\9458 .dtd” ,  line  123: 

A  parameter  entity  name  has  been  declared  more  than  once. 

The  entity  is  ”%chap”, 

<!ENTITY  %  chap  ”(%titles;,  ((section,  section+)  |  para0+) , 


<!--  **Warning**  in  ”\xgml\9458 .dtd" ,  line  138: 

An  element  with  mixed  content  should  permit  data  characters  ("#PCDATA”) 
everywhere . 

The  element  being  declared  is  "CBLOC”. 

<! ELEMENT  cbloc  -  o  (%text;,  cb+)  > 

/\ 

-  -  > 

<!--  **Waming**  in  ”\xgml\9458  .dtd” ,  line  206: 

An  element  is  not  allowed  in  the  document  instsmce  because  it  does  not 
appear  in  any  accessible  content  model  or  it  is  completely  excluded. 
The  element  is  "ADDRESS". 


««<  PART  OF  MESSAGE  TEXT  REMOVED  HERE  »>» 
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The 

element 

is 

"APPENDIX”  . 

The 

element 

is 

”BRK” . 

The 

element 

is 

"CHGINSSHT" . 

The 

element 

is 

"CHGLIST” . 

The 

element 

is 

"CHGREC" . 

The 

element 

is 

”DOC” . 

The 

element 

is 

"DOCPART” . 

The 

element 

is 

"FOLDSECT” . 

The 

element 

is 

"GLOSSARY” . 

The 

element 

is 

"INDEX” . 

The 

element 

is 

"INSERTPG" . 

The 

element 

is 

"INTRO" . 

The 

element 

is 

"PGBRK” . 

The 

element 

is 

"PREFACE" . 

The 

element 

is 

"REAR”  . 

The 

element 

is 

"REMOVEPG”  . 

The 

element 

is 

"SECTION” . 

The 

element 

is 

"SHORTTITLE" 

The 

element 

is 

"VOLUME"  . 

The 

element 

is 

"WARNPAGE” . 

<««  ERRORS  FROM  THIS  POINT  ON  RELATE  TO  NO  DOCUMENT  INSTANCE  AND  ARE  NOT  CONSIDERED 
FOR  THIS  REPORT  >»» 

<1..  **Error**  in  "\xgml\9458 .dtd" ,  line  207: 

The  document  instance  must  consist  of  at  least  one  tag  or  data  character. 

The  following  element  can  start:  "DOCFRM" . 

-  -> 


<««  PART  OF  LOG  FILE  REMOVED  HERE  »>» 


<1..  **Error**  in  "\xgml\9458 .dtd" ,  line  207:  An  end  tag  that  has  been  declared  inomis 
must  not  be  omitted.  The  element  is  "DOCFRM".  --> 

< ! - -  Capacity  points/limits : 


TOTALCAP 

ENTCAP 

ENTCHCAP 

ELEMCAP 

GRPCAP 

EXGRPCAP 

EXMMCAP 

ATTCAP 

ATTCHCAP 

AVGRPCAP 

NOTCAP 

NOTCHCAP 

IDCAP 


=110250/200000 

=12800/200000 

=11526/70000 

=5440/70000 

=29472/70000 

=704/70000 

=1184/70000 

=31840/200000 

=865/70000 

=16160/70000 

=96/70000 

=163/70000 

=0/70000 
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IDREFCAP  =0/70000 
MAPCAP  =0/70000 
LKSETCAP  =0/70000 
LKNMCAP  =0/70000  --> 

<!--  85  errors  and  26  warnings  reported.  --> 

6.2  Exoterica  XGMLNornializer  Parser 


C:\XOlL\XGMLN0RM.EXE  -- 

Warning  on  line  138  in  file  9458. dtd: 

An  element  with  mixed  content  does  not  permit  data  characters 
everywhere . 

Spaces  and  line  breaks  in  element  'CBLOC  may  be  treated  as  data 
characters,  forcing  insertion  of  markup. 

6.3  Public  Domain  sgmls  Log 

sgmls:  In  file  included  at  \ws\9458 .dtd,  line  52: 

Warning  at  i:\dtd\784c.dtd,  line  37  in  declaration  parameter  4: 
Duplicate  specification  occurred  for  *'%shortitleuse” ;  duplicate  ignored 
sgmls:  In  file  included  at  \ws\9458 .dtd,  line  52: 

Warning  at  i:\dtd\784c.dtd,  line  45  in  declaration  parameter  4: 
Duplicate  specification  occurred  for  "%shortitle” ;  duplicate  ignored 
sgmls:  In  file  included  at  \ws\9458 .dtd,  line  52: 

Warning  at  i:\dtd\784c.dtd,  line  109  in  declaration  parameter  4: 
Duplicate  specification  occurred  for  ”%fmt";  duplicate  ignored 
sgmls:  In  file  included  at  \ws\9458 .dtd,  line  52: 

Warning  at  i:\dtd\784c.dtd,  line  186  in  declaration  parameter  4: 
Duplicate  specification  occurred  for  "%chap'';  duplicate  ignored 
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<j..***  fiie:\xginl\9458.dtd  line:  138  pos:3897 

Potential  problem  in  the  mixed  content  model  of  element  CBLOC . 

At  some  location  within  the  model,  the  entry  of  separators  between  tags 
will  not  always  be  permitted.  It  is  often  possible  to  fix  this  problem 
by  writing  the  #PCDATA  model  token  in  a  repeatable  OR  group. --> 

ATTCNT  --100--  48 
ATTSPLEN  --960--  0 
BSEQLEN  --960--  0 
DTAGLEN  0 

DTEMPLEN  0 

ENTLVL  2 

GRPCNT  --32--  22 
GRPGTCNT  --96--  27 
GRPLVL  --16--  5 
LITLEN  --3048--  730 
NAMELEN  --32--  13 
NORMSEP  --2--  0 
PILEN  --240--  0 
TAGLEN  --960--  0 
TAGLVL  --24--  0 
MSDLVL  --24--  1 
TOTALCAP  - -200000- -  117416 
ENTCAP  --200000--  16032 
ENTCHCAP  - -70000- -  10663 
ELEMCAP  - -70000- -  5440 
GRPCAP  - -70000- -  34240 
EXGRPCAP  - -70000- -  736 
EXNMCAP  - -70000- -  1184 
ATTCAP  --200000--  31840 
ATTCHCAP  -- 70000 --  865 
AVGRPCAP  -- 70000 --  16160 
NOTCAP  - -70000- -  96 
NOTCHCAP  - -70000- -  160 
IDCAP  --70000--  0 
IDREFCAP  -- 70000 --  0 
MAPCAP  --70000--  0 
LKSETCAP  -- 70000 --  0 
LKNMCAP  --70000--  0 
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